3 January 1995 HEBREW CALENDAR for WINDOWS Version 7.2 =========================== FEATURES -------- *Covers 600 years: Common 1600-2200, Hebrew 5360-5960 *Convert dates from Common-to-Hebrew or Hebrew-to-Common *Instantly display dates on dual calendars with holidays; sunrise, sunset, Shabbat candle lighting and ending times; and Hours-of-Time (Shaot Zmanot) *QuickDate feature for rapid date entry or conversion *Mini-Floating Window option, alway stays on top of other applications *Accurate sunrise/sunset times at user-defined location *Print full month calendars with Truetype fonts showing both dates, holidays, and times *Holiday/observance lists for each year *Israel/Diaspora preference selectable *First-of-Month relationships for each year *Shabbat (annual cycle) and holiday Torah/Haftarah readings *12/24-hour time formats *Shabbat candle lighting and ending times with respect to sunset with selectable defaults or can be set for specific locations *Selectable date formats (MM-DD-YYYY and DD-MM-YYYY) *Yahrzeit and birthday anniversaries with selectable printing range *Personal anniversary database shows date of next observance *Geographic database for cities *Readings and holiday descriptions in user-editable text files *Direct access to Windows Cardfile and Notepad for personal information *Windows Clipboard and Printer support *Point-and-click user interface INSTALLATION ------------ a) From Supplied Disk: Run SETUP on the installation floppy disk from Windows. b) From ZIP File: UnZIP to a subdirectory such as HEBCAL. Install HEBCALW.EXE in a Windows program group. You must have VBRUN300.DLL in your Windows System subdirectory to run HEBREW CALENDAR. If you don't have this run-time library, it is probably available from the same source where you acquired HEBREW CALENDAR. If you have registered, enter your name and ID number EXACTLY as received on the Information & Registration selection on the Main Menu. SAVE A COPY OF YOUR ID NUMBER!!!!! If you lose it, contact the Calendar Maven. INSTALLATION PROBLEMS --------------------- ID Number Not Recognized as Valid - Your registered name and number must be entered exactly as received. This includes spaces, punctuation, and any ampersands. DDEML.DLL Cannot Be Installed - Ignore and continue with installation. Setup Cannot Install Some Files - May be related to VER.DLL in your Windows System subdirectory. Rename it VER.DL_ and run Setup again. Colors Are Wrong - May be related to THREED.VBX. If this file is in your Hebrew Calendar subdirectory, try copying it to your Windows System subdirectory. COMMDLG.DLL Warning - This file is being used by another and probably non-obvious program. Enter IGNORE. If problems persist, contact the Calendar Maven. DO NOT contact PsL, Compuserve or anyone else. UPGRADING/UPDATING FROM PREVIOUS VERSIONS ----------------------------------------- This version may be installed directly over previous versions since 7.0. If you are currently using an older version, delete all previous files or install to a new directory. Starting with Version 7.0, the format of HEBCAL.CFG and CITIES.DAT was changed. Older format files will not work properly with newer versions of HEBREW CALENDAR. This version will not overwrite HEBCAL.CFG, PERSONAL.DAT, HEBCAL.TXT or HEBCAL.CRD. UPGRADES AND UPDATES -------------------- An "update" corrects bugs and problems or makes some minor program improvements. An "upgrade" represents the incorporation of major improvements or features. Updates: At present, there are no plans to charge for updates. New versions are regularly posted to America Online (AOL), Compuserve (CIS) and Internet. AOL: Go SOFTWARE CIS: Go RELIGION, Judaism section Internet: Various FTP including Jerusalem1 and SIMTEL If you prefer, a 3-1/2 inch floppy disk with the latest version may be ordered directly from the Calendar Maven for US$6 (cash, check or money order) to cover shipping and handling. This disk is not available through PsL or Compuserve. Upgrades: Registered users must obtain a new ID number. If you have registered HEBREW CALENDAR within the past 60-days, the upgrade is free by contacting the Calendar Maven directly for a new ID number. DO NOT contact PsL or Compuserve. If you registered more than 60-days ago, the upgrade fee is US$10, add US$3 for a disk with the latest version. This payment may be made through the same methods as regular registration, see below. COPYING AND DISTRIBUTION ------------------------ HEBREW CALENDAR is distributed as shareware and may be copied and distributed without fee other than for nominal distribution costs. The distribution files must not be altered in anyway. You may give copies to your friends and any other interested parties. The distribution of the intact, unaltered ZIP file is encouraged! Feel free to upload to your favorite BBS, online service, or Internet FTP. If registered, you may NOT give your personal ID number to anyone. FREE EVALUATION --------------- As shareware, you can evaluate the program free of charge. If you find HEBREW CALENDAR useful and continue to use it, you must register and pay the required fee. LICENSE AND DISCLAIMER ---------------------- HEBREW CALENDAR is licensed for the personal use of the registered user on two computers, for example, work and at home. Every effort has been made to ensure the accuracy of HEBREW CALENDAR, however, the Calendar Maven assumes no liability for errors, problems, or consequences due to its use. The Calendar Maven reserves the right to make changes, corrections and improvements without notification or obligation. HELP ---- The only form of help available within HEBREW CALENDAR are the ABOUT... buttons and the Help panels at the bottom of most of the Windows. The Help panels display context sensitive information relevant to particular controls or the location of the mouse cursor. QUICKDATE --------- QuickDate provides the means for direct date entry, either Common or Hebrew. This can be used for quick date conversion or as a "go-to-date" capability in the Calendars. From the Main Menu, QuickDate provides a miniature Window that can provide a convenient means of converting dates for use in other applications. As an option, QuickDate can be made to "float," staying on top of all other applications, or can be selected to startup immediately upon starting HEBREW CALENDAR. TORAH/HAFTARAH READINGS ----------------------- Shabbat readings are based on the annual schedule defined in Arthur Spier's "The Comprehensive Hebrew Calendar." Readings may be accessed from the Calendar and Readings Window using either the Readings button or clicking the right mouse button on a Saturday or holiday. MODIFYING HOLIDAY DESCRIPTIONS AND TORAH/HAFTARAH READINGS ---------------------------------------------------------- The descriptions and readings are contained in separate text files, HOLIDAYS.DAT and READINGS.DAT, respectively. This allows SKILLED users to make changes to match preferences. Instructions are noted in each file. DO NOT attempt to make changes unless you are familiar with text file formats and editing. Since weekly readings may draw from several different selections, the user is cautioned when any making changes. The most common changes might be to edit selections showing optional Sephardi and Ashkenazi rituals to indicate one's specific preference. ANNIVERSARIES ------------- You may determine both birthday and yahrzeit anniversaries, which have slightly different rules. The birthday feature may be used for general anniversaries as well. COMMON YEARS AND THE GREGORIAN CALENDAR --------------------------------------- As used in HEBREW CALENDAR, the Common dates follow the classic Gregorian calendar devised in 1582. The Gregorian calendar was NOT universally adopted. For example, the United States and United Kingdom did not make the change until 1752. Therefore, users are advised to determine what calendar rules apply in different countries, especially when researching older dates. SUNRISE/SUNSET TIMES -------------------- Beginning with Version 7.2, HEBREW CALENDAR uses a new improved algorithm which appears to be accurate to within a minute or two at sea-level. If you find that the sunrise/sunset times are not accurate enough for your requirements, you may need to input the elevation for your location using Sunset Setup from the Main Menu. Your local elevation above sea-level, can be obtained from local weather bureaus, maps, or airports. With elevation correction, the algorithm should provide sea-level accuracy at your location. SHABBAT CANDLE LIGHTING AND END TIMES ------------------------------------- HEBREW CALENDAR provides default times of 18 minutes and 45 minutes, respectively, for candle lighting on Friday and the end of Shabbat on Saturday. These defaults may be changed in Preferences from the Main Menu. Recognizing that local customs may vary, these times may be set independently for each location using Location Setup from the Main Menu. For example, Jerusalem candle lighting can be 40 minutes without changing the 18 minute candle lighting in New York City. CITY LIST --------- The city list for sunset setup has been greatly expanded through the help of Joseph Lattke (Gateshead Ltd.). 'Yosef' is affiliated with LUACH (Calendar), a Jewish BBS. You can login to LUACH at 1-201-656-3942. Except as noted, all cities in the supplied database use a default elevation of 0 meters and the default Shabbat times. Jerusalem has a candle lighting time of 40 minutes. Canton, Ohio has an elevation of 366 meters. ORDERS, REGISTRATION, UPDATES AND UPGRADES ------------------------------------------ To avoid the annoying reminder messages you must obtain a user ID number by registering. All required information and registration assistance can be accessed from the "Information & Registration" selection on the Main Menu. You may register/upgrade by: a) Cash, check or money order payable in US funds/banks. * US$24 for registration and a FREE 3-1/2 inch disk with the latest version of HEBREW CALENDAR. * US$6 for 3-1/2 inch disk with the latest version of HEBREW CALENDAR. Does not include registration. * US$10 for upgrade re-registration only (no disk). * US$13 for upgrade re-registration and 3-1/2 inch disk with the latest version of HEBREW CALENDAR. You must specify version number of HEBREW CALENDAR being registered. Send cash, check or money order, payable in US funds/banks, to: Joseph Kohn The Calendar Maven 4333 Larchwood Circle, NW Canton, OH 44718-2117 USA b) Mastercard, Visa, American Express or Discover Card * US$24 for registration only (no disk). * US$27 for registration and 3-1/2 inch disk with the latest version of HEBREW CALENDAR. * US$13 for upgrade re-registration and 3-1/2 inch disk with the latest version of HEBREW CALENDAR. You must specify version number of HEBREW CALENDAR being registered. Charge card registration is available from PsL: Product Name: Hebrew Calendar Product Number: 11546 Mailing Address: PsL PO Box 35705 Houston, TX 77235-5705 USA Toll-Free Voice in USA Only: 800-242-4775 Outside USA: 713-524-6394 FAX: 713-524-6398 Compuserve: 71355,470 NOTE: PsL CANNOT PROVIDE YOUR USER ID NUMBER OR DISK!!! PsL forwards your order information to the Calendar Maven!!! CONTACT PsL TO PLACE ORDERS ONLY!!! CONTACT THE CALENDAR MAVEN (SEE BELOW) FOR ORDER INQUIRIES AND ANY MATTERS RELATED TO HEBREW CALENDAR!!! c) Compuserve Shareware Registration Go SWREG. * Search ID: 4176 Registration: US$24, registration only (no disk). * Search ID: 4177 Upgrade Re-Registration: US$10, re-registration only (no disk). NOTE: COMPUSERVE CANNOT PROVIDE YOUR USER ID NUMBER!!! ALLOW TIME FOR ORDER PROCESSING AND MAILING, ESPECIALLY OUTSIDE THE US. CONTACT THE CALENDAR MAVEN (SEE BELOW) IF YOU HAVE ANY ORDER PROBLEMS!!! DO NOT CONTACT PsL OR COMPUSERVE. TECHNICAL SUPPORT ----------------- Contact the Calendar Maven. DO NOT contact PsL, Compuserve, or anyone else. PRICING/QUESTIONS/SUGGESTIONS/ORDER INQUIRIES --------------------------------------------- Contact the Calendar Maven. Ask about: *Quantity discounts *Site licenses *Fund raising *Customization PLANNED IMPROVEMENTS -------------------- *Synagogue-level yahrzeit database *Printed/printable manual *Triennial Torah/Haftarah readings *PIM features ---------------------------------------------------------------------------- THE CALENDAR MAVEN ---------------------------------------------------------------------------- Mailing Address: Joseph Kohn 4333 Larchwood Circle, NW Canton, OH 44718-2117 USA America Online: JoeMKohn Compuserve: 74651,116 Internet: joemkohn@aol.com ---------------------------------------------------------------------------- Windows Version History ----------------------- 7.2a 950103 New SWREG ID numbers. 7.2 950101 Added Rosh Hodesh and Shabbat observances. Added sunrise time. Many cosmetic changes. Added holiday Torah readings. Floating mini-Window feature. No longer requires HEBCAL.TXT and HEBCAL.CRD for Notepad and Cardfile. NOTEPAD.EXE and CARDFILE.EXE must be in Windows directory. Changed user ID numbers requiring user re-registration for upgrade. Major changes in Calendars: reduced Windows resource requirements, improved re-draw and readability. Added hour-of-time (sha'a zmani). Replaced sunrise/sunset algorithm for better accuracy. Candle lighting and end of Shabbat with user-set defaults or can be set by location. 7.13b941120 Corrected several Haftarah readings associated with Rosh Hodesh. Added QuickDate feature. Expanded to 600 year range. HEBCAL.CFG file no longer required, defaults set automatically. Added separate READINGS.DAT and HOLIDAYS.DAT files. Several cosmetic changes. 7.13a941116 Revised 30 Adar I yahrzeit to match revised Spier rules, i.e., 30 Shevat rather than 29 Adar in ordinary years. Yahrzeit lists no longer crippled in the unregistered copies. Added birthday anniversaries. Save last anniversary feature. Daylight savings option on Main Menu. 7.13 941107 Fixed Heshvan/Kislev 30 yahrzeit bug. 7.12 941104 Fixed non-US TYPE MISMATCH error. 7.11d941029 Fixed Common multicalendar printout bug. 941028 Setup 1.1: Modified floppy SETUP procedure to install all VBX and DLL into HEBCAL directory, only VBRUN300.DLL is installed to the Windows System subdirectory. This should eliminate apparant library clashes. 7.11c941019 Made Hebrew year default for month relationships. Added some additional descriptive information. 7a 941015 Maintenance upgrade to 7.1. Does not include All Fonts feature. 7.11b941015 Fixed Clipboard problems. Made Hebrew year default for month relationships. 7.11a941006 Corrected Readings button bug. 7.11 941003 Added All Fonts feature to Calendar Font Setup. 7.1 941001 Fixed bugs in Common Calendar holiday displays. Added Truetype for calendar prinouts. Added more date format flexibility. Minor improvements here and there. 7.02 940924 Added delete for cities and yahrzeit lists. Added support for Notepad and Cardfile. 7.01 940920 Fixed problem with Holiday spin buttons and years that were displayed. 7.0 940916 Shabbat Torah/Haftarah readings completed. Changed HEBCAL.CFG and CITIES.DAT format. Can write cities directly from Sunset Setup to CITIES.DAT database file. Preferences for time format, date format and Israel/Diaspora readings. Added Yom Hazikron and Yom Yerushalayim. Modified Shavuot and Passover for Diaspora/- Israel. Fixed Adar I yahrzeit bug. Added personal yahrzeit database. Changed About... windows to use scrolling textbox. 6.02 940908 Right-click for Torah readings. 6.01 940901 Added additional 3D effects. Fixed some typos. No functional changes. 6.0 940828 Added charge card registration. Added name textbox to Yahrzeit window. First upload to Compuserve. 5.52 940812 Calendar Window: February 31 bug, added month change buttons, improved speed, made day=1 after month change. 5.51 940808 Improved Calendar window load by keeping it loaded. Undone in 7.02. 5.5 940807 Introduced Torah/Haftarah readings format for comment. Changed to multicolumn list boxes. Corrected year subtitle in Holiday printout. Many cosmetic changes. 5.46 940727 Made Holiday common year radio button match initial year. Fixed again in 7.1. 5.45 940716 Fixed bug in Sunset calculation for southern latitudes. 5.44 940703 Minimized icon now displays current Hebrew date. 5.43 940630 Fixed bug in to allow '-' entry in Sunset Setup. Major fix for large part of the world. Added sunset times to monthly calendar printouts. 5.4b 940506 Changed registration fee schedule, candle lighting time for Shabbat eve, added Help lines. 5.4a 940416 Corrected Yom Hashoah and Yom Ha'Atzmaut Shabbat shift. 5.4 940331 Enhanced Common month printout. Added Hebrew month printout. 5.3c 940330 Refined print selection from Calendars Window. 5.3b 940326 Added password security. 5.3a 940321 Added holiday durations. 5.3 940313 Added clipboard to Main Menu "Today" items. Corrected Shavuot second day omission. Corrected bug with Today changing after Calendar access. 5.2 940308 Holiday display on Main Menu. Added font error handler. 5.1 940303 Made Month Relationships separate Main Menu item. 5.0 940301 First Windows release. DOS Version History (DOS version is no longer supported) --------------------------------------------------------- 2.5 940216 Corrected yahrzeit listing to start on correct year. 2.4 931225 Added sundown question for yahrzeit. Distribution files include Windows icon and PIF file. 2.3 920603 Made compatible with QBX 7.1 and Hercules video cards. 2.2 Corrected yahrzeit for Adar II leap year. 2.1 Added Yizkor information. 2.0 Added descriptions of the holidays. 1.4 Added auto display of title screen. 1.21 Added improved windows for single video page operation. 1.08 Made shareware. 1.07 No Yom Haatzmaut prior to 1949 and no Yom Hashoah prior to 1951. 1.06 Corrected for Shabbat instead of Saturday, and Yom Haatzmaut. 1.05 Added Statistics for year. 1.04 Added "Shabbat" instead of Saturday.